Day8 - Laravel Migration

16th鐵人賽

fufu04

團隊好想工作室 v8.0

2024-09-22 18:15:21

50 瀏覽

分享至

哈! 用個小故事來當引言好惹~~😊

從前，有一個小鎮，住著許多熱愛看書小精靈👻。他們每天都忙著搜尋各類書籍，讓小鎮變得更加有文學氣息。但因為書籍實在是太多了，該怎麼管理小精靈們的書籍呢？

1. Migration 是什麼？

某天，精靈們決定建造一間書店，於是開始建立一個管理書籍的系統，以便妥善收藏和查詢每本書📚。他們知道，Migration 能幫助他們輕鬆地新增和修改內容，並確保每位精靈在不同地方都能看到相同的書籍系統。接下來，讓我們一起看看精靈們如何完成建立、修改和刪除書籍系統的資料表。

2. 生成與編寫 Migration

小精靈們首先使用魔法指令 php artisan make:migration 來生成一個新的管理表格，命名為 create_books_table，這樣就能妥善記錄所有書籍資訊，讓書店的運作變得有條不紊。

php artisan make:migration create_books_table

以下是這段管理表格的內容：

up() 方法：這裡是精靈們新增書本資料的地方，叫做books。
- 書籍ID
- 書名（title）
- 作者（author）
- 出版年份（published_year），
- 記錄每本書的創建時間（timestamps）
down() 方法：表格需要移除的地方。

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateBooksTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('books', function (Blueprint $table) {
            $table->id(); // 書籍ID
            $table->string('title'); // 書名
            $table->string('author'); // 作者
            $table->integer('published_year'); // 出版年份
            $table->timestamps(); // 時間戳記
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('books'); // 刪除books資料表
    }
}

3. 修改資料表

隨著書籍數量的增長，小精靈們發現需要為每本書增加一個 genre（類別）欄位，這樣他們就能夠更好地分類書籍。於是，他們使用了魔法指令 php artisan make:migration 創建了一個新的 Migration 來修改資料表，表格取名為 add_genre_to_books_table

php artisan make:migration add_genre_to_books_table

在 AddGenreToBooksTable 檔案中，這段程式碼會在 books資料表中添加一個 genre欄位，並允許其為空值。如果需要回滾變更，可以用 down() 方法刪除這個欄位。

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class AddGenreToBooksTable extends Migration
{
    public function up()
    {
        Schema::table('books', function (Blueprint $table) {
            $table->string('genre')->nullable(); // 新增genre欄位
        });
    }

    public function down()
    {
        Schema::table('books', function (Blueprint $table) {
            $table->dropColumn('genre'); // 刪除genre欄位
        });
    }
}

4. 刪除資料表

可是有一天，精靈們覺得不想再看書了，決定使用 Schema::drop() 方法來刪除整個 books 資料表：

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class DropBooksTable extends Migration
{
    public function up()
    {
        Schema::dropIfExists('books'); // 刪除books資料表
    }
    public function down()
    {
	    // 如果需要，這裡可以重新創建資料表
        Schema::create('books', function (Blueprint $table) {
            $table->id(); // 書籍ID
            $table->string('title'); // 書名
            $table->string('author'); // 作者
            $table->integer('published_year'); // 出版年份
            $table->timestamps(); // 時間戳記
        });
    }
}